Improve the documentation for gtk_builder_connect_signals. (#514471)

2008-02-10  Philip Withnall  <pwithnall@svn.gnome.org>

	* gtk/gtkbuilder.c: Improve the documentation for
	gtk_builder_connect_signals. (#514471)

svn path=/trunk/; revision=19507

diff --git a/ChangeLog b/ChangeLog
index 5c7a6707585e34b4deb6c9db3c552373a5db6432..5c253dc12bc9d500ea07a7613eef8dbf1cf672ef 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2008-02-10  Philip Withnall  <pwithnall@svn.gnome.org>
+
+       * gtk/gtkbuilder.c: Improve the documentation for
+       gtk_builder_connect_signals. (#514471)
+
 2008-02-10  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtkrecentaction.c: Propagate local-only.  (#511987, 

diff --git a/gtk/gtkbuilder.c b/gtk/gtkbuilder.c
index 0d1d05b89278ce437fa90672ca27d2158a6337f7..87c42f60d4f5a7d68f810fc4019e572912e1824f 100644 (file)
--- a/gtk/gtkbuilder.c
+++ b/gtk/gtkbuilder.c
@@ -850,6 +850,12 @@ gtk_builder_connect_signals_default (GtkBuilder    *builder,
  * Note that this function will not work correctly if #GModule is not
  * supported on the platform.
  *
+ * When compiling applications for Windows, you must declare signal callbacks
+ * with #G_MODULE_EXPORT, or they will not be put in the symbol table.
+ * On Linux and Unices, this is not necessary; applications should instead
+ * be compiled with the -Wl,--export-dynamic CFLAGS, and linked against
+ * gmodule-export-2.0.
+ *
  * Since: 2.12
  **/
 void